home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 51 / Amiga Format CD51 (2000-03-10)(Future Publishing)(GB)[!][issue 2000-04].iso / -in_the_mag- / pdselect / awnp / awnp-docs / textfield.doc < prev    next >
Text File  |  2000-02-16  |  3KB  |  129 lines
  1. TextField gadget event.
  2. -------------------------
  3. NOTE: The textfield gadget has two event forms. For more information see the shortevent parameter below
  4.  
  5. Short Event
  6. 'gadget GID'
  7.  
  8. or Default event.
  9. 'gadget GID size <newline> characters[size]'
  10.  
  11. The next 'size' number of characters after the newline are the contents of the TextField gadget.
  12.  
  13. Textfield gadget parameters.
  14. -------------------------
  15.  
  16. font=GID
  17.  
  18. This sets the font for the gadget. The GID points to an ALREADY defined text attribute.
  19.  
  20. arrows (a)
  21.  
  22.  Give the textfield a scroll gadget on the right.
  23.  
  24. readonly (ro)
  25.  
  26.  This gadget is read only.
  27.  
  28. disable=number (dis=)
  29.  
  30.  The gadget is disabled if number = 0 , enabled if number != 0. Defaults to enabled.
  31.  
  32. TabCycle (tc)
  33.  
  34.  This gadget can be activated using the tab key.
  35.  
  36. gadgettext="text" (gt=)
  37.  
  38.  Set the text in the gadget.
  39.  
  40. bindata (bd)
  41.  
  42. The text will be passed to this pipe in binary after the command line. The gadgettext parameter now gives the length of the data. Setting datain means the data is read from an external file rather than the pipe.
  43.  
  44. datain="filename" (di=)
  45.  
  46.  Read the data for this gadget from a file.
  47. It is ignored if the Bindata keyword is not present. A length of 0 means to use the complete file.
  48.  
  49. shortevent  (se)
  50.  
  51.  The events sent by the textfield gadget do not include the contenets of the textfield. This paramter only works if modify is turned on.Also see events above.
  52.  
  53.  
  54. centerjustify  (cj)
  55. rightjustify   (rj)
  56.  
  57.  Set the justification of the text for the gadget. Defaults to leftjustify.
  58.  
  59. bevel=TYPE  (b=)
  60.  
  61.  Set the bevel type for this gadget.
  62.  
  63. 0=NONE
  64. 1=THIN
  65. 2=BUTTON
  66. 3=GROUP
  67. 4=FIELD
  68. 5=DROPBOX
  69. 6=SBAR_HORIZ
  70. 7=SBAR_VERT
  71. 8=BOX
  72. 9=STANDARD
  73.  
  74.  
  75. minwidth=number (minw=)
  76.  
  77.  Set the minimum width for this gadget
  78.  
  79. minheight=number (minh=)
  80.  
  81.  Set the minimum height for this gadget
  82.  
  83. weightedwidth=number (weiw=)
  84.  
  85.  Set the weighted width for this gadget
  86.  
  87. weightedheight=number (weih=)
  88.  
  89.  Set the weighted height for this gadget
  90.  
  91. nominalsize (noms)
  92.  
  93.  Set this gadget to its nominal size.
  94.  
  95. replace=GID
  96.  
  97.  Use this gadget to replace an existing gadget specified by GID.
  98.  
  99. Definition Reply
  100. -----------------
  101.  
  102.  When the gadget creation is successful the pipe replies with
  103.  
  104. 'ok GID'
  105.  
  106. Textfield gadget modify parameters.
  107. -------------------------
  108. disable=number (dis=)
  109.  
  110.  The gadget is disabled if number = 0 , enabled if number != 0.
  111.  
  112. gadgettext="text" (gt=)
  113.  
  114.  Set the text in the gadget to text if scroll keyword is not used. Else insert the text at the position set by scroll.
  115.  
  116. scroll="num"
  117.  
  118.  Set the cursor to position num.
  119.  
  120. delete=num
  121.  
  122.  Delete num of characters from the cursor forward.
  123.  
  124. bindata (bd)
  125.  
  126. The text will be passed to this pipe in binary after the command line. The gadgettext parameter now gives the length of the data. Note that you can NOT use datain durring modify.
  127.  
  128. All modifications of a textfield (except a lone disable) are responded to by 'ok POSITION' where POSITION is the final curser position.
  129.